home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3c / sem_unlink.z / sem_unlink
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeemmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))                                                    sssseeeemmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk - deletes a posix named semaphore
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_eeee_mmmm_aaaa_pppp_hhhh_oooo_rrrr_eeee_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_n_a_m_e_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk deletes the semaphore, named by the character string at
  18.      address _n_a_m_e, from the file namespace.  The named semaphore and its state
  19.      will persist after the call to _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk, if one or more processes still
  20.      reference the semaphore. Once the last reference has been dropped, the
  21.      semaphore ceases to exist [see _ssss_eeee_mmmm______cccc_llll_oooo_ssss_eeee(2)].
  22.  
  23.      _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk will fail if one or more of the following are true:
  24.  
  25.      [EACCES]       Search permission is denied for a component of the _n_a_m_e
  26.                     prefix.
  27.  
  28.      [EACCES]       Write permission is denied on the directory containing the
  29.                     semaphore to be removed and the process does not have the
  30.                     super-user privilege.
  31.  
  32.      [EACCES]       The parent directory has the sticky bit set and the
  33.                     semaphore is not writable by the user; the user does not
  34.                     own the parent directory and the user does not own the
  35.                     semaphore.
  36.  
  37.      [EACCES]       Write permission is denied on the semaphore named by _n_a_m_e.
  38.  
  39.      [EFAULT]       _n_a_m_e points outside the process's allocated address space.
  40.  
  41.      [EINTR]        A signal was caught during the _ssss_eeee_mmmm______uuuu_nnnn_llll_iiii_nnnn_kkkk system call.
  42.  
  43.      [ELOOP]        Too many symbolic links were encountered in translating
  44.                     _n_a_m_e.
  45.  
  46.      [ENAMETOOLONG] The length of the _n_a_m_e argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or the
  47.                     length of a _n_a_m_e component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while
  48.                     ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  49.  
  50.      [ENOENT]       The named semaphore does not exist or is a null pathname.
  51.  
  52.      [ENOTDIR]      A component of the _n_a_m_e is not a directory.
  53.  
  54.      [EPERM]        The named semaphore is a directory.
  55.  
  56.      [EROFS]        The semaphore to be unlinked is part of a read-only file
  57.                     system.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeemmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))                                                    sssseeeemmmm____uuuunnnnlllliiiinnnnkkkk((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _ssss_eeee_mmmm______oooo_pppp_eeee_nnnn(1), _ssss_eeee_mmmm______cccc_llll_oooo_ssss_eeee(2)
  76.  
  77. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  79.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.